home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmTextField.z / XmTextField
Encoding:
Text File  |  2002-10-03  |  96.7 KB  |  1,387 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd - The TextField class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////TTTTeeeexxxxttttFFFF....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           TextField widget provides a single line text editor for
  20.           customizing both user and programmatic interfaces.  It is
  21.           used for single-line string entry, and forms entry with
  22.           verification procedures.  It provides an application with a
  23.           consistent editing system for textual data.
  24.  
  25.           TextField widget provides separate callback lists to verify
  26.           movement of the insert cursor, modification of the text, and
  27.           changes in input focus.  Each of these callbacks provides
  28.           the verification function with the widget instance, the
  29.           event that caused the callback, and a data structure
  30.           specific to the verification type.  From this information
  31.           the function can verify if the application considers this to
  32.           be a legitimate state change and can signal the widget
  33.           whether to continue with the action.
  34.  
  35.           The user interface tailors a new set of actions.  The key
  36.           bindings have been added for insert cursor movement,
  37.           deletion, insertion, and selection of text.
  38.  
  39.           TextField allows the user to select regions of text.
  40.           Selection is based on the model specified in the _I_n_t_e_r-
  41.           _C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l (ICCCM).  TextField
  42.           supports primary and secondary selection.
  43.  
  44.         CCCCllllaaaasssssssseeeessss
  45.           TextField widget inherits behavior and resources from CCCCoooorrrreeee
  46.           and PPPPrrrriiiimmmmiiiittttiiiivvvveeee classes.
  47.  
  48.           The class pointer is xxxxmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  49.  
  50.           The class name is XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd.
  51.  
  52.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  53.           The following table defines a set of widget resources used
  54.           by the programmer to specify data.  The programmer can also
  55.           set the resource values for the inherited classes to set
  56.           attributes for this widget.  To reference a resource by name
  57.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  58.           prefix and use the remaining letters.  To specify one of the
  59.           defined values for a resource in a .Xdefaults file, remove
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           the XXXXmmmm prefix and use the remaining letters (in either lower
  75.           case or upper case, but include any underscores between
  76.           words).  The codes in the access column indicate if the
  77.           given resource can be set at creation time (C), set by using
  78.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  79.           not applicable (N/A).
  80.  
  81.                                           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddRRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  82.      NNNNaaaammmmeeee                         CCCCllllaaaassssssss                      TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt           AAAAcccccccceeeessssssss
  83.      _________________________________________________________________________________________________
  84.      XmNactivateCallback          XmCCallback                XtCallbackList   NULL              C
  85.      XmNblinkRate                 XmCBlinkRate               int              500               CSG
  86.      XmNcolumns                   XmCColumns                 short            dynamic           CSG
  87.      XmNcursorPosition            XmCCursorPosition          XmTextPosition   0                 CSG
  88.      XmNcursorPositionVisible     XmCCursorPositionVisible   Boolean          True              CSG
  89.      XmNeditable                  XmCEditable                Boolean          True              CSG
  90.      XmNfocusCallback             XmCCallback                XtCallbackList   NULL              C
  91.      XmNfontList                  XmCFontList                XmFontList       dynamic           CSG
  92.      XmNgainPrimaryCallback       XmCCallback                XtCallbackList   NULL              C
  93.      XmNlosePrimaryCallback       XmCCallback                XtCallbackList   NULL              C
  94.      XmNlosingFocusCallback       XmCCallback                XtCallbackList   NULL              C
  95.      XmNmarginHeight              XmCMarginHeight            Dimension        5                 CSG
  96.      XmNmarginWidth               XmCMarginWidth             Dimension        5                 CSG
  97.      XmNmaxLength                 XmCMaxLength               int              largest integer   CSG
  98.      XmNmodifyVerifyCallback      XmCCallback                XtCallbackList   NULL              C
  99.      XmNmodifyVerifyCallbackWcs   XmCCallback                XtCallbackList   NULL              C
  100.      XmNmotionVerifyCallback      XmCCallback                XtCallbackList   NULL              C
  101.      XmNpendingDelete             XmCPendingDelete           Boolean          True              CSG
  102.      XmNresizeWidth               XmCResizeWidth             Boolean          False             CSG
  103.      XmNselectionArray            XmCSelectionArray          XtPointer        default array     CSG
  104.      XmNselectionArrayCount       XmCSelectionArrayCount     int              3                 CSG
  105.      XmNselectThreshold           XmCSelectThreshold         int              5                 CSG
  106.      XmNvalue                     XmCValue                   String           ""                CSG
  107.      XmNvalueChangedCallback      XmCCallback                XtCallbackList   NULL              C
  108.      XmNvalueWcs                  XmCValueWcs                wchar_t *        (wchar_t *)""     CSG*
  109.      XmNverifyBell                XmCVerifyBell              Boolean          dynamic           CSG
  110.           *  This resource cannot be specified in a resource file.
  111.  
  112.  
  113.           XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk
  114.                     Specifies the list of callbacks that is called
  115.                     when the user invokes an event that calls the
  116.                     AAAAccccttttiiiivvvvaaaatttteeee(((()))) function.  The type of the structure
  117.                     whose address is passed to this callback is
  118.                     XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
  119.                     callback is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE.
  120.  
  121.           XXXXmmmmNNNNbbbblllliiiinnnnkkkkRRRRaaaatttteeee
  122.                     Specifies the blink rate of the text cursor in
  123.                     milliseconds.  The time indicated in the blink
  124.                     rate relates to the length of time the cursor is
  125.                     visible and the time the cursor is invisible
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                     (i.e., the time it will take to blink the
  141.                     insertion cursor on and off will be 2 times the
  142.                     blink rate).  The cursor will not blink when the
  143.                     blink rate is set to zero.  The value must not be
  144.                     negative.
  145.  
  146.           XXXXmmmmNNNNccccoooolllluuuummmmnnnnssss
  147.                     Specifies the initial width of the text window as
  148.                     an integer number of characters.  The width equals
  149.                     the number of characters specified by this
  150.                     resource multiplied by the maximum character width
  151.                     of the associated font.  For proportionate fonts,
  152.                     the actual number of characters that fit on a
  153.                     given line may be greater than the value
  154.                     specified.  The value must be greater than 0.  The
  155.                     default value depends on the value of the XXXXmmmmNNNNwwwwiiiiddddtttthhhh
  156.                     resource.  If no width is specified the default is
  157.                     20.
  158.  
  159.           XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn
  160.                     Indicates the position in the text where the
  161.                     current insert cursor is to be located.  Position
  162.                     is determined by the number of characters from the
  163.                     beginning of the text.
  164.  
  165.           XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnnVVVViiiissssiiiibbbblllleeee
  166.                     Indicates that the insert cursor position is
  167.                     marked by a blinking text cursor when the Boolean
  168.                     is True.
  169.  
  170.           XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee
  171.                     Indicates that the user can edit the text string
  172.                     when set to True.  A false value will prohibit the
  173.                     user from editing the text.
  174.  
  175.           XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
  176.                     Specifies the list of callbacks called when
  177.                     TextField accepts input focus.  The type of the
  178.                     structure whose address is passed to this callback
  179.                     is XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
  180.                     callback is XXXXmmmmCCCCRRRR____FFFFOOOOCCCCUUUUSSSS.
  181.  
  182.           XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
  183.                     Specifies the font list to be used for TextField.
  184.                     If this value is NULL at initialization, it is
  185.                     initialized by looking up the parent hierarchy of
  186.                     the widget for an ancestor that is a subclass of
  187.                     the XmBulletinBoard or VendorShell widget class.
  188.                     If such an ancestor is found, the font list is
  189.                     initialized to the XXXXmmmmNNNNtttteeeexxxxttttFFFFoooonnnnttttLLLLiiiisssstttt of the ancestor
  190.                     widget. If no such ancestor is found, the default
  191.                     is implementation dependent.  Refer to
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                     XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt((((3333XXXX)))) for more information on a font list
  207.                     structure.
  208.  
  209.                     TextField searches the font list for the first
  210.                     occurrence of a font set that has a
  211.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG.  If a default element is
  212.                     not found, the first font set in the font list is
  213.                     used.  If the list contains no font sets, the
  214.                     first font in the font list is used.
  215.  
  216.           XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
  217.                     Specifies the list of callbacks that are called
  218.                     when the user invokes an event that cause the text
  219.                     widget to gain ownership of the primary selection.
  220.                     The callback reason for this callback is
  221.                     XXXXmmmmCCCCRRRR____GGGGAAAAIIIINNNN____PPPPRRRRIIIIMMMMAAAARRRRYYYY.
  222.  
  223.           XXXXmmmmNNNNlllloooosssseeeePPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
  224.                     Specifies the list of callbacks that are called
  225.                     when the user invokes an event that cause the text
  226.                     widget to lose ownership of the primary selection.
  227.                     The callback reason for this callback is
  228.                     XXXXmmmmCCCCRRRR____LLLLOOOOSSSSEEEE____PPPPRRRRIIIIMMMMAAAARRRRYYYY.
  229.  
  230.           XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
  231.                     Specifies the list of callbacks that is called
  232.                     before TextField widget loses input focus.  The
  233.                     type of the structure whose address is passed to
  234.                     this callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The
  235.                     reason sent by the callback is XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.
  236.  
  237.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
  238.                     Specifies the distance between the top edge of the
  239.                     widget window and the text, and the bottom edge of
  240.                     the widget window and the text.
  241.  
  242.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
  243.                     Specifies the distance between the left edge of
  244.                     the widget window and the text, and the right edge
  245.                     of the widget window and the text.
  246.  
  247.           XXXXmmmmNNNNmmmmaaaaxxxxLLLLeeeennnnggggtttthhhh
  248.                     Specifies the maximum length of the text string
  249.                     that can be entered into text from the keyboard.
  250.                     This value must be non-negative.  Strings that are
  251.                     entered using the XXXXmmmmNNNNvvvvaaaalllluuuueeee resource or the
  252.                     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSttttrrrriiiinnnngggg function ignore this
  253.                     resource.
  254.  
  255.           XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
  256.                     Specifies the list of callbacks that is called
  257.                     before text is deleted from or inserted into
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     TextField.  The type of the structure whose
  273.                     address is passed to this callback is
  274.                     XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by
  275.                     the callback is XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE.  When
  276.                     multiple TextField widgets share the same source,
  277.                     only the widget that initiates the source change
  278.                     will generate the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk.
  279.  
  280.                     If both XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk and
  281.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss are registered callback
  282.                     lists, the procedure(s) in the
  283.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list are always executed
  284.                     first; and the resulting data, which may have been
  285.                     modified, is passed to the
  286.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss callback routines.
  287.  
  288.           XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss
  289.                     Specifies the list of callbacks called before text
  290.                     is deleted from or inserted into Text.  The type
  291.                     of the structure whose address is passed to this
  292.                     callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttWWWWccccssss.  The
  293.                     reason sent by the callback is
  294.                     XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE.  When multiple
  295.                     TextField widgets share the same source, only the
  296.                     widget that initiates the source change will
  297.                     generate the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss.
  298.  
  299.                     If both XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk and
  300.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss are registered callback
  301.                     lists, the procedure(s) in the
  302.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list are always executed
  303.                     first; and the resulting data, which may have been
  304.                     modified, is passed to the
  305.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss callback routines.
  306.  
  307.           XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
  308.                     Specifies the list of callbacks that is called
  309.                     before the insert cursor is moved to a new
  310.                     position.  The type of the structure whose address
  311.                     is passed to this callback is
  312.                     XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent  by
  313.                     the callback is XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  It is
  314.                     possible more than one XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkks to
  315.                     be generated from a single action.
  316.  
  317.           XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
  318.                     Indicates that pending delete mode is on when the
  319.                     Boolean is True.  Pending deletion is defined as
  320.                     deletion of the selected text when an insertion is
  321.                     made.
  322.  
  323.           XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeeWWWWiiiiddddtttthhhh
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                     Indicates that TextField widget will attempt to
  339.                     resize its width to accommodate all the text
  340.                     contained in the widget when Boolean is True.
  341.  
  342.           XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy
  343.                     Defines the actions for multiple-mouse clicks.
  344.                     Each mouse click performed within a half of a
  345.                     second of the previous mouse click will increment
  346.                     the index into this array and perform the defined
  347.                     action for that index.  The possible actions are:
  348.  
  349.  
  350.                       +o  XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN-resets the insert cursor
  351.                          position.
  352.  
  353.                       +o  XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____WWWWOOOORRRRDDDD-selects a word.
  354.  
  355.                       +o  XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____LLLLIIIINNNNEEEE-selects a line of text.
  356.  
  357.  
  358.           XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyyCCCCoooouuuunnnntttt
  359.                     Specifies the number of actions that are defined
  360.                     in the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy resource.  The value must
  361.                     not be negative.
  362.  
  363.           XXXXmmmmNNNNsssseeeelllleeeeccccttttTTTThhhhrrrreeeesssshhhhoooolllldddd
  364.                     Specifies the number of pixels of motion that is
  365.                     required to select the next character when
  366.                     selection is performed using the click-drag mode
  367.                     of selection.  The value must not be negative.
  368.  
  369.           XXXXmmmmNNNNvvvvaaaalllluuuueeee  Specifies the string value of the TextField widget
  370.                     as a cccchhhhaaaarrrr**** data value. If XXXXmmmmNNNNvvvvaaaalllluuuueeee and XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss
  371.                     are both defined, the value of XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss
  372.                     supersedes that of XXXXmmmmNNNNvvvvaaaalllluuuueeee.  XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns
  373.                     a copy of the value of the internal buffer and
  374.                     XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss copies the string values into the
  375.                     internal buffer.
  376.  
  377.           XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  378.                     Specifies the list of callbacks that is called
  379.                     after text is deleted from or inserted into
  380.                     TextField.  The type of the structure whose
  381.                     address is passed to this callback is
  382.                     XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
  383.                     callback is XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.  When multiple
  384.                     TextField widgets share the same source, only the
  385.                     widget that initiates the source change will
  386.                     generate the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk.  This
  387.                     callback represents a change in the source in the
  388.                     TextField, not in the TextField widget.  The
  389.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk should occur only in pairs
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                     with a XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, assuming that the
  405.                     _d_o_i_t flag in the callback structure of the
  406.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk is not set to False.
  407.  
  408.           XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss
  409.                     Specifies the string value of the TextField widget
  410.                     as a wwwwcccchhhhaaaarrrr____tttt**** data value.  This resource cannot be
  411.                     specified in a resource file.
  412.  
  413.                     If XXXXmmmmNNNNvvvvaaaalllluuuueeee and XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss are both defined, the
  414.                     value of XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss supersedes that of XXXXmmmmNNNNvvvvaaaalllluuuueeee.
  415.                     XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns a copy of the value of the
  416.                     internal buffer encoded as a wide character
  417.                     string.  XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss copies the value of the wide
  418.                     character string into the internal buffer.
  419.  
  420.           XXXXmmmmNNNNvvvveeeerrrriiiiffffyyyyBBBBeeeellllllll
  421.                     Specifies whether a bell will sound when an action
  422.                     is reversed during a verification callback.  The
  423.                     default depends on the value of the ancestor
  424.                     VendorShell's XXXXmmmmNNNNaaaauuuuddddiiiibbbblllleeeeWWWWaaaarrrrnnnniiiinnnngggg resource.
  425.  
  426.  
  427.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  428.           TextField widget inherits behavior and resources from the
  429.           following superclasses.  For a complete description of these
  430.           resources, refer to the man page for that superclass.
  431.  
  432.                                          XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  433.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  434.      ________________________________________________________________________________________________
  435.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel              dynamic                CSG
  436.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap             XmUNSPECIFIED_PIXMAP   CSG
  437.      XmNforeground           XmCForeground           Pixel              dynamic                CSG
  438.      XmNhelpCallback         XmCCallback             XtCallbackList     NULL                   C
  439.      XmNhighlightColor       XmCHighlightColor       Pixel              dynamic                CSG
  440.      XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean            False                  CSG
  441.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap             dynamic                CSG
  442.      XmNhighlightThickness   XmCHighlightThickness   Dimension          2                      CSG
  443.      XmNnavigationType       XmCNavigationType       XmNavigationType   XmTAB_GROUP            CSG
  444.      XmNshadowThickness      XmCShadowThickness      Dimension          2                      CSG
  445.      XmNtopShadowColor       XmCTopShadowColor       Pixel              dynamic                CSG
  446.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap             dynamic                CSG
  447.      XmNtraversalOn          XmCTraversalOn          Boolean            True                   CSG
  448.      XmNunitType             XmCUnitType             unsigned char      dynamic                CSG
  449.      XmNuserData             XmCUserData             XtPointer          NULL                   CSG
  450.  
  451.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  452.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  453.      ______________________________________________________________________________________________________________
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  467.  
  468.  
  469.  
  470.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  471.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  472.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  473.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  474.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  475.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  476.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  477.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  478.      XmNdepth                        XmCDepth                        int              dynamic                CG
  479.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  480.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  481.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  482.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  483.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  484.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  485.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  486.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  487.      XmNx                            XmCPosition                     Position         0                      CSG
  488.      XmNy                            XmCPosition                     Position         0                      CSG
  489.  
  490.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  491.           A pointer to the following structure is passed to each
  492.           callback:
  493.  
  494.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  495.           {{{{
  496.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  497.             XXXXEEEEvvvveeeennnntttt       * _e_v_e_n_t;;;;
  498.           }}}} XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  499.  
  500.  
  501.           _r_e_a_s_o_n Indicates why the callback was invoked.
  502.  
  503.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.
  504.  
  505.  
  506.           The TextField widget defines a new callback structure for
  507.           use with verification callbacks.  Note that not all of the
  508.           fields are relevant for every callback reason.  The
  509.           application must first look at the _r_e_a_s_o_n field and use only
  510.           the structure members that are valid for the particular
  511.           reason.  The values _s_t_a_r_t_P_o_s, _e_n_d_P_o_s, and _t_e_x_t in the
  512.           callback structure XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt may be
  513.           modified upon receiving the callback, and these changes will
  514.           be reflected as the change made to the source of the
  515.           TextField widget.  (For example, all keystrokes can be
  516.           converted to spaces or NULL characters when a password is
  517.           entered into a TextField widget.)  The application
  518.           programmer should not overwrite the _t_e_x_t field, but should
  519.           attach data to that pointer.
  520.  
  521.           A pointer to the following structure is passed to the
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  533.  
  534.  
  535.  
  536.           callbacks for XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk,
  537.           XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, and XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk.
  538.  
  539.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  540.           {{{{
  541.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  542.             XXXXEEEEvvvveeeennnntttt       ****_e_v_e_n_t;;;;
  543.             BBBBoooooooolllleeeeaaaannnn      _d_o_i_t;;;;
  544.             XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn_c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t;;;;
  545.             XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn_s_t_a_r_t_P_o_s, _e_n_d_P_o_s;;;;
  546.             XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkk  _t_e_x_t;;;;
  547.           }}}} XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyPPPPttttrrrr;;;;
  548.  
  549.  
  550.           _r_e_a_s_o_n Indicates why the callback was invoked.
  551.  
  552.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.  It
  553.                  can be NULL.  For example, changes made to the Text
  554.                  widget programmatically do not have an event that can
  555.                  be passed to the associated callback.
  556.  
  557.           _d_o_i_t   Indicates whether that action that invoked the
  558.                  callback will be performed.  Setting _d_o_i_t to False
  559.                  negates the action.
  560.  
  561.           _c_u_r_r_I_n_s_e_r_t
  562.                  Indicates the current position of the insert cursor.
  563.  
  564.           _n_e_w_I_n_s_e_r_t
  565.                  Indicates the position at which the user attempts to
  566.                  position the insert cursor.
  567.  
  568.           _s_t_a_r_t_P_o_s
  569.                  Indicates the starting position of the text to
  570.                  modify.  If the callback is not a modify verification
  571.                  callback, this value is the same as _c_u_r_r_I_n_s_e_r_t.
  572.  
  573.           _e_n_d_P_o_s Indicates the ending position of the text to modify.
  574.                  If no text is replaced or deleted, then the value is
  575.                  the same as _s_t_a_r_t_P_o_s.  If the callback is not a
  576.                  modify verification callback, this value is the same
  577.                  as _c_u_r_r_I_n_s_e_r_t.
  578.  
  579.           _t_e_x_t   Points to a structure of type XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeecccc.  This
  580.                  structure holds the textual information to be
  581.                  inserted.
  582.  
  583.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  584.           {{{{
  585.             cccchhhhaaaarrrr         ****_p_t_r;;;;
  586.             iiiinnnntttt          _l_e_n_g_t_h;;;;
  587.             XXXXmmmmTTTTeeeexxxxttttFFFFoooorrrrmmmmaaaatttt _f_o_r_m_a_t
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 4/30/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  599.  
  600.  
  601.  
  602.           }}}} XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeecccc,,,, ****XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkk;;;;
  603.  
  604.  
  605.           _p_t_r    Is the text to be inserted.  _p_t_r points to a
  606.                  temporary storage space that is reused after the
  607.                  callback is finished. Therefore, if an application
  608.                  needs to save the text to be inserted, it should copy
  609.                  the text into its own data space.
  610.  
  611.           _l_e_n_g_t_h Specifies the length of the text to be inserted.
  612.  
  613.           _f_o_r_m_a_t Specifies the format of the text, either XXXXmmmmFFFFMMMMTTTT____8888____BBBBIIIITTTT
  614.                  or XXXXmmmmFFFFMMMMTTTT____11116666____BBBBIIIITTTT.
  615.  
  616.  
  617.           A pointer to the following structure is passed to callbacks
  618.           for XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss.
  619.  
  620.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  621.           {{{{
  622.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  623.             XXXXEEEEvvvveeeennnntttt       ****_e_v_e_n_t;;;;
  624.             BBBBoooooooolllleeeeaaaannnn      _d_o_i_t;;;;
  625.             XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn_c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t;;;;
  626.             XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn_s_t_a_r_t_P_o_s, _e_n_d_P_o_s;;;;
  627.             XXXXmmmmWWWWccccssssTTTTeeeexxxxttttBBBBlllloooocccckkkk_t_e_x_t;;;;
  628.           }}}} XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttWWWWccccssss,,,, ****XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyPPPPttttrrrrWWWWccccssss;;;;
  629.  
  630.  
  631.           _r_e_a_s_o_n Indicates why the callback was invoked.
  632.  
  633.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.  It
  634.                  can be NULL.  For example, changes made to the Text
  635.                  widget programmatically do not have an event that can
  636.                  be passed to the associated callback.
  637.  
  638.           _d_o_i_t   Indicates whether the action that invoked the
  639.                  callback is performed.  Setting _d_o_i_t to False negates
  640.                  the action.
  641.  
  642.           _c_u_r_r_I_n_s_e_r_t
  643.                  Indicates the current position of the insert cursor.
  644.  
  645.           _n_e_w_I_n_s_e_r_t
  646.                  Indicates the position at which the user attempts to
  647.                  position the insert cursor.
  648.  
  649.           _s_t_a_r_t_P_o_s
  650.                  Indicates the starting position of the text to
  651.                  modify.  If the callback is not a modify verification
  652.                  callback, this value is the same as _c_u_r_r_I_n_s_e_r_t.
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 4/30/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  665.  
  666.  
  667.  
  668.           _e_n_d_P_o_s Indicates the ending position of the text to modify.
  669.                  If no text is replaced or deleted, the value is the
  670.                  same as _s_t_a_r_t_P_o_s.  If the callback is not a modify
  671.                  verification callback, this value is the same as
  672.                  _c_u_r_r_I_n_s_e_r_t.
  673.  
  674.           _t_e_x_t   Points to a structure of type XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeeccccWWWWccccssss.
  675.                  This structure holds the textual information to be
  676.                  inserted.
  677.  
  678.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  679.           {{{{
  680.                   wwwwcccchhhhaaaarrrr____tttt ****_w_c_s_p_t_r;;;;
  681.                   iiiinnnntttt    _l_e_n_g_t_h;;;;
  682.           }}}} XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeeccccWWWWccccssss,,,, ****XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkWWWWccccssss;;;;
  683.  
  684.  
  685.           _w_c_s_p_t_r Points to the wide character text to be inserted.
  686.  
  687.           _l_e_n_g_t_h Specifies the number of characters to be inserted.
  688.  
  689.  
  690.           The following table describes the reasons for which the
  691.           individual verification callback structure fields are valid:
  692.  
  693.                         RRRReeeeaaaassssoooonnnn                  VVVVaaaalllliiiidddd FFFFiiiieeeellllddddssss
  694.                __________________________________________________
  695.                XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS           _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t
  696.  
  697.                XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE   _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t,
  698.                                            _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t,
  699.                                            _s_t_a_r_t_P_o_s, _e_n_d_P_o_s, _t_e_x_t
  700.  
  701.                XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR   _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t,
  702.                                            _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t
  703.  
  704.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  705.           XmTextField includes translations from XmPrimitive.  The
  706.           XmTextField translations are listed below.  These
  707.           translations may not directly correspond to a translation
  708.           table.  The actions represent the effective behavior of the
  709.           associated events, and they may differ in a right-to-left
  710.           language environment.
  711.  
  712.           BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss:::: ggggrrrraaaabbbb----ffffooooccccuuuussss(((())))
  713.           BBBBSSSSeeeelllleeeecccctttt MMMMoooottttiiiioooonnnn::::eeeexxxxtttteeeennnndddd----aaaaddddjjjjuuuusssstttt(((())))
  714.           BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee::::eeeexxxxtttteeeennnndddd----eeeennnndddd(((())))
  715.  
  716.           BBBBEEEExxxxtttteeeennnndddd PPPPrrrreeeessssssss:::: eeeexxxxtttteeeennnndddd----ssssttttaaaarrrrtttt(((())))
  717.           BBBBEEEExxxxtttteeeennnndddd MMMMoooottttiiiioooonnnn::::eeeexxxxtttteeeennnndddd----aaaaddddjjjjuuuusssstttt(((())))
  718.           BBBBEEEExxxxtttteeeennnndddd RRRReeeelllleeeeaaaasssseeee::::eeeexxxxtttteeeennnndddd----eeeennnndddd(((())))
  719.  
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 4/30/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  731.  
  732.  
  733.  
  734.           BBBBTTTToooogggggggglllleeee PPPPrrrreeeessssssss:::: mmmmoooovvvveeee----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn(((())))
  735.  
  736.           BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::   pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  737.           BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn::::  sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((())))
  738.           BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee:::: ccccooooppppyyyy----ttttoooo(((())))
  739.  
  740.           MMMMCCCCttttrrrrllll BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  741.           MMMMCCCCttttrrrrllll BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn::::sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((())))
  742.           MMMMCCCCttttrrrrllll BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::ccccooooppppyyyy----ttttoooo(((())))
  743.  
  744.           MMMMSSSShhhhiiiifffftttt BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  745.           MMMMSSSShhhhiiiifffftttt BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn::::sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((())))
  746.           MMMMSSSShhhhiiiifffftttt BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::mmmmoooovvvveeee----ttttoooo(((())))
  747.  
  748.           MMMMAAAAlllltttt BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  749.           MMMMAAAAlllltttt BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn::::sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((())))
  750.           MMMMAAAAlllltttt BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::ccccooooppppyyyy----ttttoooo(((())))
  751.           MMMMAAAAlllltttt MMMMCCCCttttrrrrllll BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::ccccooooppppyyyy----ttttoooo(((())))
  752.           MMMMAAAAlllltttt MMMMSSSShhhhiiiifffftttt BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::mmmmoooovvvveeee----ttttoooo(((())))
  753.  
  754.           KKKKUUUUpppp::::           ttttrrrraaaavvvveeeerrrrsssseeee----pppprrrreeeevvvv(((())))
  755.  
  756.           KKKKDDDDoooowwwwnnnn::::         ttttrrrraaaavvvveeeerrrrsssseeee----nnnneeeexxxxtttt(((())))
  757.  
  758.           KKKKLLLLeeeefffftttt::::         bbbbaaaacccckkkkwwwwaaaarrrrdddd----cccchhhhaaaarrrraaaacccctttteeeerrrr(((())))
  759.           MMMMSSSShhhhiiiifffftttt KKKKLLLLeeeefffftttt::::  kkkkeeeeyyyy----sssseeeelllleeeecccctttt((((lllleeeefffftttt))))
  760.           MMMMCCCCttttrrrrllll KKKKLLLLeeeefffftttt::::   bbbbaaaacccckkkkwwwwaaaarrrrdddd----wwwwoooorrrrdddd(((())))
  761.           MMMMSSSShhhhiiiifffftttt MMMMCCCCttttrrrrllll KKKKLLLLeeeefffftttt::::bbbbaaaacccckkkkwwwwaaaarrrrdddd----wwwwoooorrrrdddd((((eeeexxxxtttteeeennnndddd))))
  762.  
  763.           KKKKRRRRiiiigggghhhhtttt::::        ffffoooorrrrwwwwaaaarrrrdddd----cccchhhhaaaarrrraaaacccctttteeeerrrr(((())))
  764.           MMMMSSSShhhhiiiifffftttt KKKKRRRRiiiigggghhhhtttt:::: kkkkeeeeyyyy----sssseeeelllleeeecccctttt((((rrrriiiigggghhhhtttt))))
  765.           MMMMCCCCttttrrrrllll KKKKRRRRiiiigggghhhhtttt::::  ffffoooorrrrwwwwaaaarrrrdddd----wwwwoooorrrrdddd(((())))
  766.           MMMMSSSShhhhiiiifffftttt MMMMCCCCttttrrrrllll KKKKRRRRiiiigggghhhhtttt::::ffffoooorrrrwwwwaaaarrrrdddd----wwwwoooorrrrdddd((((eeeexxxxtttteeeennnndddd))))
  767.  
  768.           KKKKPPPPaaaaggggeeeeLLLLeeeefffftttt::::     ppppaaaaggggeeee----lllleeeefffftttt(((())))
  769.           KKKKPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt::::    ppppaaaaggggeeee----rrrriiiigggghhhhtttt(((())))
  770.  
  771.           KKKKBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee::::    bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----lllliiiinnnneeee(((())))
  772.           MMMMSSSShhhhiiiifffftttt KKKKBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee::::bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----lllliiiinnnneeee((((eeeexxxxtttteeeennnndddd))))
  773.  
  774.           KKKKEEEEnnnnddddLLLLiiiinnnneeee::::      eeeennnndddd----ooooffff----lllliiiinnnneeee(((())))
  775.           MMMMSSSShhhhiiiifffftttt KKKKEEEEnnnnddddLLLLiiiinnnneeee::::eeeennnndddd----ooooffff----lllliiiinnnneeee((((eeeexxxxtttteeeennnndddd))))
  776.  
  777.           KKKKNNNNeeeexxxxttttFFFFiiiieeeelllldddd::::    nnnneeeexxxxtttt----ttttaaaabbbb----ggggrrrroooouuuupppp(((())))
  778.           KKKKPPPPrrrreeeevvvvFFFFiiiieeeelllldddd::::    pppprrrreeeevvvv----ttttaaaabbbb----ggggrrrroooouuuupppp(((())))
  779.  
  780.           KKKKAAAAccccttttiiiivvvvaaaatttteeee::::     aaaaccccttttiiiivvvvaaaatttteeee(((())))
  781.  
  782.           KKKKDDDDeeeelllleeeetttteeee::::       ddddeeeelllleeeetttteeee----nnnneeeexxxxtttt----cccchhhhaaaarrrraaaacccctttteeeerrrr(((())))
  783.           KKKKBBBBaaaacccckkkkSSSSppppaaaacccceeee::::    ddddeeeelllleeeetttteeee----pppprrrreeeevvvviiiioooouuuussss----cccchhhhaaaarrrraaaacccctttteeeerrrr(((())))
  784.  
  785.           KKKKAAAAddddddddMMMMooooddddeeee::::      ttttoooogggggggglllleeee----aaaadddddddd----mmmmooooddddeeee(((())))
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 4/30/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  797.  
  798.  
  799.  
  800.           KKKKSSSSppppaaaacccceeee::::        sssseeeellllffff----iiiinnnnsssseeeerrrrtttt(((())))
  801.           MMMMSSSShhhhiiiifffftttt KKKKSSSSppppaaaacccceeee:::: sssseeeellllffff----iiiinnnnsssseeeerrrrtttt(((())))
  802.           KKKKSSSSeeeelllleeeecccctttt::::       sssseeeetttt----aaaannnncccchhhhoooorrrr(((())))
  803.           KKKKEEEExxxxtttteeeennnndddd::::       kkkkeeeeyyyy----sssseeeelllleeeecccctttt(((())))
  804.           MMMMAAAAnnnnyyyy KKKKCCCCaaaannnncccceeeellll::::  pppprrrroooocccceeeessssssss----ccccaaaannnncccceeeellll(((())))
  805.           KKKKCCCClllleeeeaaaarrrr::::        cccclllleeeeaaaarrrr----sssseeeelllleeeeccccttttiiiioooonnnn(((())))
  806.           KKKKSSSSeeeelllleeeeccccttttAAAAllllllll::::    sssseeeelllleeeecccctttt----aaaallllllll(((())))
  807.           KKKKDDDDeeeesssseeeelllleeeeccccttttAAAAllllllll::::  ddddeeeesssseeeelllleeeecccctttt----aaaallllllll(((())))
  808.  
  809.           KKKKCCCCuuuutttt::::          ccccuuuutttt----cccclllliiiippppbbbbooooaaaarrrrdddd(((())))
  810.           KKKKCCCCooooppppyyyy::::         ccccooooppppyyyy----cccclllliiiippppbbbbooooaaaarrrrdddd(((())))
  811.           KKKKPPPPaaaasssstttteeee::::        ppppaaaasssstttteeee----cccclllliiiippppbbbbooooaaaarrrrdddd(((())))
  812.  
  813.           KKKKPPPPrrrriiiimmmmaaaarrrryyyyCCCCuuuutttt::::   ccccuuuutttt----pppprrrriiiimmmmaaaarrrryyyy(((())))
  814.           KKKKPPPPrrrriiiimmmmaaaarrrryyyyCCCCooooppppyyyy::::  ccccooooppppyyyy----pppprrrriiiimmmmaaaarrrryyyy(((())))
  815.           KKKKPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee:::: ccccooooppppyyyy----pppprrrriiiimmmmaaaarrrryyyy(((())))
  816.  
  817.           KKKKHHHHeeeellllpppp::::         HHHHeeeellllpppp(((())))
  818.  
  819.           KKKKAAAAnnnnyyyy::::          sssseeeellllffff----iiiinnnnsssseeeerrrrtttt(((())))
  820.  
  821.  
  822.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  823.           The XmText action routines are described below:
  824.  
  825.  
  826.           aaaaccccttttiiiivvvvaaaatttteeee(((()))):
  827.                     Calls the callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk.  If
  828.                     the parent is a manager, passes the event to the
  829.                     parent.
  830.  
  831.           bbbbaaaacccckkkkwwwwaaaarrrrdddd----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  832.                     Moves the insertion cursor one character to the
  833.                     left.  For other effects, see the description of
  834.                     navigation operations in the "Keyboard Selection"
  835.                     section in XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).  This action may have
  836.                     different behavior in a right-to-left language
  837.                     environment.
  838.  
  839.           bbbbaaaacccckkkkwwwwaaaarrrrdddd----wwwwoooorrrrdddd((((_e_x_t_e_n_d)))):
  840.                     If this action is called with no argument, moves
  841.                     the insertion cursor to the first non-whitespace
  842.                     character after the first whitespace character to
  843.                     the left or after the beginning of the line.  If
  844.                     the insertion cursor is already at the beginning
  845.                     of a word, moves the insertion cursor to the
  846.                     beginning of the previous word.  For other
  847.                     effects, see the description of navigation
  848.                     operations in the "Keyboard Selection" section in
  849.                     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).  This action may have different
  850.                     behavior in a locale other than the C locale.
  851.  
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 4/30/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  863.  
  864.  
  865.  
  866.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  867.                     insertion cursor as in the case of no argument and
  868.                     extends the current selection.  For other effects,
  869.                     see the description of shifted navigation
  870.                     operations in the "Keyboard Selection" section in
  871.                     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).
  872.  
  873.           bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----lllliiiinnnneeee((((_e_x_t_e_n_d)))):
  874.                     If this action is called with no argument, moves
  875.                     the insertion cursor to the beginning of the line.
  876.                     For other effects, see the description of
  877.                     navigation operations in the "Keyboard Selection"
  878.                     section in XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).
  879.  
  880.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  881.                     insertion cursor as in the case of no argument and
  882.                     extends the current selection.  For other effects,
  883.                     see the description of shifted navigation
  884.                     operations in the "Keyboard Selection" section in
  885.                     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).
  886.  
  887.           cccclllleeeeaaaarrrr----sssseeeelllleeeeccccttttiiiioooonnnn(((()))):
  888.                     Clears the current selection by replacing each
  889.                     character except <<<<RRRReeeettttuuuurrrrnnnn>>>> with a <<<<ssssppppaaaacccceeee>>>>
  890.                     character.
  891.  
  892.           ccccooooppppyyyy----cccclllliiiippppbbbbooooaaaarrrrdddd(((()))):
  893.                     Copies the current selection to the clipboard.
  894.  
  895.           ccccooooppppyyyy----pppprrrriiiimmmmaaaarrrryyyy(((()))):
  896.                     Copies the primary selection to just before the
  897.                     insertion cursor.
  898.  
  899.           ccccooooppppyyyy----ttttoooo(((()))):
  900.                     If a secondary selection exists, copies the
  901.                     secondary selection to just before the insertion
  902.                     cursor.  If no secondary selection exists, copies
  903.                     the primary selection to the pointer location.
  904.  
  905.           ccccuuuutttt----cccclllliiiippppbbbbooooaaaarrrrdddd(((()))):
  906.                     Cuts the current selection to the clipboard.
  907.  
  908.           ccccuuuutttt----pppprrrriiiimmmmaaaarrrryyyy(((()))):
  909.                     Cuts the primary selection to just before the
  910.                     insertion cursor.
  911.  
  912.           ddddeeeelllleeeetttteeee----nnnneeeexxxxtttt----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  913.                     In normal mode if there is a non-null selection,
  914.                     deletes the selection, otherwise deletes the
  915.                     character following the insertion cursor.  In add
  916.                     mode if there is a non-null selection, the cursor
  917.                     is not disjoint from the selection and
  918.  
  919.  
  920.  
  921.      Page 14                                         (printed 4/30/98)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  929.  
  930.  
  931.  
  932.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  933.                     selection, otherwise deletes the character
  934.                     following the insertion cursor.  This may impact
  935.                     the selection.
  936.  
  937.           ddddeeeelllleeeetttteeee----nnnneeeexxxxtttt----wwwwoooorrrrdddd(((()))):
  938.                     In normal mode if there is a non-null selection,
  939.                     deletes the selection, otherwise deletes the
  940.                     characters following the insertion cursor to the
  941.                     next space, tab or end of line character.  In add
  942.                     mode if there is a non-null selection, the cursor
  943.                     is not disjoint from the selection and
  944.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  945.                     selection, otherwise deletes the characters
  946.                     following the insertion cursor to the next space,
  947.                     tab or end of line character.  This may impact the
  948.                     selection.  This action may have different
  949.                     behavior in a locale other than the C locale.
  950.  
  951.           ddddeeeelllleeeetttteeee----pppprrrreeeevvvviiiioooouuuussss----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  952.                     In normal mode if there is a non-null selection,
  953.                     deletes the selection, otherwise deletes the
  954.                     character of text immediately preceding the
  955.                     insertion cursor.  In add mode if there is a non-
  956.                     null selection, the cursor is not disjoint from
  957.                     the selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True,
  958.                     deletes the selection, otherwise deletes the
  959.                     character of text immediately preceding the
  960.                     insertion cursor.  This may impact the selection.
  961.  
  962.           ddddeeeelllleeeetttteeee----pppprrrreeeevvvviiiioooouuuussss----wwwwoooorrrrdddd(((()))):
  963.                     In normal mode if there is a non-null selection,
  964.                     deletes the selection, otherwise deletes the
  965.                     characters preceding the insertion cursor to the
  966.                     next space, tab or beginning of the line
  967.                     character.  In add mode if there is a non-null
  968.                     selection, the cursor is not disjoint from the
  969.                     selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True,
  970.                     deletes the selection, otherwise deletes the
  971.                     characters preceding the insertion cursor to the
  972.                     next space, tab or beginning of line character..
  973.                     This may impact the selection.  This action may
  974.                     have different behavior in a locale other than the
  975.                     C locale.
  976.  
  977.           ddddeeeelllleeeetttteeee----sssseeeelllleeeeccccttttiiiioooonnnn(((()))):
  978.                     Deletes the current selection.
  979.  
  980.           ddddeeeelllleeeetttteeee----ttttoooo----eeeennnndddd----ooooffff----lllliiiinnnneeee(((()))):
  981.                     In normal mode if there is a non-null selection,
  982.                     deletes the selection, otherwise deletes the
  983.                     characters following the insertion cursor to the
  984.  
  985.  
  986.  
  987.      Page 15                                         (printed 4/30/98)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  995.  
  996.  
  997.  
  998.                     next end of line character.  In add mode if there
  999.                     is a non-null selection, the cursor is not
  1000.                     disjoint from the selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
  1001.                     is set to True, deletes the selection, otherwise
  1002.                     deletes the characters following the insertion
  1003.                     cursor to the next end of line character.  This
  1004.                     may impact the selection.
  1005.  
  1006.           ddddeeeelllleeeetttteeee----ttttoooo----ssssttttaaaarrrrtttt----ooooffff----lllliiiinnnneeee(((()))):
  1007.                     In normal mode if there is a non-null selection,
  1008.                     deletes the selection, otherwise deletes the
  1009.                     characters preceding the insertion cursor to the
  1010.                     previous beginning of line character.  In add mode
  1011.                     if there is a non-null selection, the cursor is
  1012.                     not disjoint from the selection and
  1013.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  1014.                     selection, otherwise deletes the characters
  1015.                     preceding the insertion cursor to the previous
  1016.                     beginning of line character.  This may impact the
  1017.                     selection.
  1018.  
  1019.           ddddeeeesssseeeelllleeeecccctttt----aaaallllllll(((()))):
  1020.                     Deselects the current selection.
  1021.  
  1022.           eeeennnndddd----ooooffff----lllliiiinnnneeee((((_e_x_t_e_n_d)))):
  1023.                     If this action is called with no argument, moves
  1024.                     the insertion cursor to the end of the line.  For
  1025.                     other effects, see the description of navigation
  1026.                     operations in the "Keyboard Selection" section in
  1027.                     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).  If called with an argument of eeeexxxxtttteeeennnndddd,
  1028.                     moves the insertion cursor as in the case of no
  1029.                     argument and extends the current selection.  For
  1030.                     other effects, see the description of shifted
  1031.                     navigation operations in the "Keyboard Selection"
  1032.                     section in XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).
  1033.  
  1034.           eeeexxxxtttteeeennnndddd----aaaaddddjjjjuuuusssstttt(((()))):
  1035.                     Selects text from the anchor to the pointer
  1036.                     position and deselects text outside that range.
  1037.  
  1038.           eeeexxxxtttteeeennnndddd----eeeennnndddd(((()))):
  1039.                     Moves the insertion cursor to the position of the
  1040.                     pointer.
  1041.  
  1042.           eeeexxxxtttteeeennnndddd----ssssttttaaaarrrrtttt(((()))):
  1043.                     Adjusts the anchor using the balance-beam method.
  1044.                     Selects text from the anchor to the pointer
  1045.                     position and deselects text outside that range.
  1046.  
  1047.           ffffoooorrrrwwwwaaaarrrrdddd----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  1048.                     Moves the insertion cursor one character to the
  1049.                     right.  For other effects, see the description of
  1050.  
  1051.  
  1052.  
  1053.      Page 16                                         (printed 4/30/98)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  1061.  
  1062.  
  1063.  
  1064.                     navigation operations in the "Keyboard Selection"
  1065.                     section in XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).  This action may have
  1066.                     different behavior in a right-to-left language
  1067.                     environment.
  1068.  
  1069.           ffffoooorrrrwwwwaaaarrrrdddd----wwwwoooorrrrdddd((((_e_x_t_e_n_d)))):
  1070.                     If this action is called with no argument, moves
  1071.                     the insertion cursor to the first whitespace
  1072.                     character or end of line following the next non-
  1073.                     whitespace character.  If the insertion cursor is
  1074.                     already at the end of a word, moves the insertion
  1075.                     cursor to the end of the next word.  For other
  1076.                     effects, see the description of navigation
  1077.                     operations in the "Keyboard Selection" section in
  1078.                     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).  This action may have different
  1079.                     behavior in a locale other than the C locale.
  1080.  
  1081.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1082.                     insertion cursor as in the case of no argument and
  1083.                     extends the current selection.  For other effects,
  1084.                     see the description of shifted navigation
  1085.                     operations in the "Keyboard Selection" section in
  1086.                     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).
  1087.  
  1088.           ggggrrrraaaabbbb----ffffooooccccuuuussss(((()))):
  1089.                     This key binding performs the action defined in
  1090.                     the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy, depending on the number of
  1091.                     multiple mouse clicks.  The default selection
  1092.                     array ordering is one click to move the insertion
  1093.                     cursor to the pointer position, two clicks to
  1094.                     select a word, three clicks to select a line of
  1095.                     text, and four clicks to select all text.  A
  1096.                     single click also deselects any selected text and
  1097.                     sets the anchor at the pointer position.  This
  1098.                     action may have different behavior in a locale
  1099.                     other than the C locale.
  1100.  
  1101.           HHHHeeeellllpppp(((()))):   Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
  1102.                     exist.  If there are no help callbacks for this
  1103.                     widget, this action calls the help callbacks for
  1104.                     the nearest ancestor that has them.
  1105.  
  1106.           kkkkeeeeyyyy----sssseeeelllleeeecccctttt((((_d_i_r_e_c_t_i_o_n)))):
  1107.                     If called with an argument of rrrriiiigggghhhhtttt, moves the
  1108.                     insertion cursor one character to the right and
  1109.                     extends the current selection.  If called with an
  1110.                     argument of lllleeeefffftttt, moves the insertion cursor one
  1111.                     character to the left and extends the current
  1112.                     selection.  If called with no argument, extends
  1113.                     the current selection.  For other effects, see the
  1114.                     description of shifted navigation operations and
  1115.                     KKKKEEEExxxxtttteeeennnndddd" in the "Keyboard Selection" section in
  1116.  
  1117.  
  1118.  
  1119.      Page 17                                         (printed 4/30/98)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  1127.  
  1128.  
  1129.  
  1130.                     XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX)))).
  1131.  
  1132.           mmmmoooovvvveeee----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn(((()))):
  1133.                     Moves the insertion cursor to the pointer position
  1134.                     without changing any existing current selection.
  1135.                     If there is no current selection, sets the widget
  1136.                     as the destination widget.
  1137.  
  1138.           mmmmoooovvvveeee----ttttoooo(((()))):
  1139.                     If a secondary selection exists, cuts the
  1140.                     secondary selection to just before the insertion
  1141.                     cursor.  If no secondary selection exists, cuts
  1142.                     the primary selection to the pointer location.
  1143.  
  1144.           nnnneeeexxxxtttt----ttttaaaabbbb----ggggrrrroooouuuupppp(((()))):
  1145.                     Traverses to the next tab group.
  1146.  
  1147.           ppppaaaaggggeeee----lllleeeefffftttt(((()))):
  1148.                     Scrolls the viewing window left one page of text.
  1149.  
  1150.           ppppaaaaggggeeee----rrrriiiigggghhhhtttt(((()))):
  1151.                     Scrolls the viewing window right one page of text.
  1152.  
  1153.           ppppaaaasssstttteeee----cccclllliiiippppbbbbooooaaaarrrrdddd(((()))):
  1154.                     Pastes the contents of the clipboard before the
  1155.                     insertion cursor.
  1156.  
  1157.           pppprrrreeeevvvv----ttttaaaabbbb----ggggrrrroooouuuupppp(((()))):
  1158.                     Traverses to the previous tab group.
  1159.  
  1160.           pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  1161.                     The result of this action is determined by several
  1162.                     factors:  position of the location cursor,
  1163.                     movement of the location cursor, and the interval
  1164.                     between a BBBBDDDDrrrraaaagggg press and release.
  1165.  
  1166.                     This action copies the current selection to the
  1167.                     insertion cursor if text is selected, the location
  1168.                     cursor is disjoint from the selection, and no
  1169.                     motion is detected within a given time interval.
  1170.  
  1171.                     It performs a secondary selection and copies the
  1172.                     selection to the position where the text was last
  1173.                     edited if the cursor is disjoint from a current
  1174.                     selection (if one exists), the time interval is
  1175.                     exceeded, and movement of the location cursor is
  1176.                     detected.
  1177.  
  1178.                     The action drags the current selection if the
  1179.                     location cursor is positioned on the selection,
  1180.                     the time interval is exceeded, and movement of the
  1181.                     location cursor is detected.  This action creates
  1182.  
  1183.  
  1184.  
  1185.      Page 18                                         (printed 4/30/98)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  1193.  
  1194.  
  1195.  
  1196.                     a DragContext object whose XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss
  1197.                     resource value includes target types of
  1198.                     COMPOUND_TEXT, STRING, and TEXT.
  1199.  
  1200.           pppprrrroooocccceeeessssssss----ccccaaaannnncccceeeellll(((()))):
  1201.                     Cancels the current eeeexxxxtttteeeennnndddd----aaaaddddjjjjuuuusssstttt(((()))), sssseeeeccccoooonnnnddddaaaarrrryyyy----
  1202.                     aaaaddddjjjjuuuusssstttt(((()))) or pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg operation and leaves the
  1203.                     selection state as it was before the operation,
  1204.                     otherwise, and the parent is a manager, it passes
  1205.                     the event to the parent.
  1206.  
  1207.           sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((()))):
  1208.                     Extends the secondary selection to the pointer
  1209.                     position.
  1210.  
  1211.           sssseeeeccccoooonnnnddddaaaarrrryyyy----ssssttttaaaarrrrtttt(((()))):
  1212.                     Marks the beginning of a secondary selection.
  1213.  
  1214.           sssseeeelllleeeecccctttt----aaaallllllll(((()))):
  1215.                     Selects all text.
  1216.  
  1217.           sssseeeellllffff----iiiinnnnsssseeeerrrrtttt(((()))):
  1218.                     If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
  1219.                     disjoint from the current selection, deletes the
  1220.                     entire selection.  Inserts the character
  1221.                     associated with the key pressed before the
  1222.                     insertion cursor.
  1223.  
  1224.           sssseeeetttt----aaaannnncccchhhhoooorrrr(((()))):
  1225.                     Resets the anchor point for extended selections.
  1226.                     Resets the destination  of secondary selection
  1227.                     actions.
  1228.  
  1229.           ttttoooogggggggglllleeee----aaaadddddddd----mmmmooooddddeeee(((()))):
  1230.                     Toggles the state of Add Mode.
  1231.  
  1232.           ttttoooogggggggglllleeee----oooovvvveeeerrrrssssttttrrrriiiikkkkeeee(((()))):
  1233.                     Toggles the state of the text insertion mode.  By
  1234.                     default, characters typed into the TextField
  1235.                     widget are inserted before the position of the
  1236.                     insertion cursor.  In overstrike mode, characters
  1237.                     entered into the TextField widget replace the
  1238.                     characters that directly follow the insertion
  1239.                     cursor.  In overstrike mode, when the end of a
  1240.                     line is reached, characters are appended to the
  1241.                     end of the line.
  1242.  
  1243.           ttttrrrraaaavvvveeeerrrrsssseeee----hhhhoooommmmeeee(((()))):
  1244.                     Traverses to the first widget in the tab group.
  1245.  
  1246.           ttttrrrraaaavvvveeeerrrrsssseeee----nnnneeeexxxxtttt(((()))):
  1247.                     Traverses to the next widget in the tab group.
  1248.  
  1249.  
  1250.  
  1251.      Page 19                                         (printed 4/30/98)
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  1259.  
  1260.  
  1261.  
  1262.           ttttrrrraaaavvvveeeerrrrsssseeee----pppprrrreeeevvvv(((()))):
  1263.                     Traverses to the previous widget in the tab group.
  1264.  
  1265.  
  1266.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  1267.           This widget has the additional behavior described below:
  1268.  
  1269.  
  1270.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  1271.                     Draws the insertion cursor as solid and starts
  1272.                     blinking the cursor.
  1273.  
  1274.           <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
  1275.                     Displays the insertion cursor as a stippled I-beam
  1276.                     unless it is the destination widget.
  1277.  
  1278.  
  1279.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  1280.           The bindings for virtual keys are vendor specific.  The
  1281.           following table lists the TextField-specific bindings of
  1282.           virtual keys to actual key event descriptions in 1/Motif:
  1283.  
  1284.                               VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy BBBBiiiinnnnddddiiiinnnnggggssss
  1285.                        __________________________________
  1286.                        VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy   AAAAccccttttuuuuaaaallll KKKKeeeeyyyy EEEEvvvveeeennnnttttssss
  1287.                        ____________________________________________________________________
  1288.                        KKKKEEEExxxxtttteeeennnndddd       CCCCttttrrrrllll SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee
  1289.                                      SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffSSSSeeeelllleeeecccctttt
  1290.                        __________________________________
  1291.                        KKKKSSSSeeeelllleeeecccctttt       CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee
  1292.                                      <<<<KKKKeeeeyyyy>>>>oooossssffffSSSSeeeelllleeeecccctttt
  1293.  
  1294.           For information about bindings for virtual buttons and keys,
  1295.           see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  1296.  
  1297.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  1298.           CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX)))), XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt((((3333XXXX)))),
  1299.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttAAAAppppppppeeeennnnddddEEEEnnnnttttrrrryyyy((((3333XXXX)))), XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX)))),
  1300.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddCCCClllleeeeaaaarrrrSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddCCCCooooppppyyyy((((3333XXXX)))),
  1301.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddCCCCuuuutttt((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttBBBBaaaasssseeeelllliiiinnnneeee((((3333XXXX)))),
  1302.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttEEEEddddiiiittttaaaabbbblllleeee((((3333XXXX)))),
  1303.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttIIIInnnnsssseeeerrrrttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))),
  1304.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttLLLLaaaassssttttPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttMMMMaaaaxxxxLLLLeeeennnnggggtttthhhh((((3333XXXX)))),
  1305.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXX)))),
  1306.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))),
  1307.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnWWWWccccssss((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSttttrrrriiiinnnngggg((((3333XXXX)))),
  1308.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSttttrrrriiiinnnnggggWWWWccccssss((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSuuuubbbbssssttttrrrriiiinnnngggg((((3333XXXX)))),
  1309.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSuuuubbbbssssttttrrrriiiinnnnggggWWWWccccssss((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddIIIInnnnsssseeeerrrrtttt((((3333XXXX)))),
  1310.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddIIIInnnnsssseeeerrrrttttWWWWccccssss((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddPPPPaaaasssstttteeee((((3333XXXX)))),
  1311.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddPPPPoooossssTTTTooooXXXXYYYY((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddRRRReeeemmmmoooovvvveeee((((3333XXXX)))),
  1312.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddRRRReeeeppppllllaaaacccceeee((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddRRRReeeeppppllllaaaacccceeeeWWWWccccssss((((3333XXXX)))),
  1313.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttAAAAddddddddMMMMooooddddeeee((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttEEEEddddiiiittttaaaabbbblllleeee((((3333XXXX)))),
  1314.  
  1315.  
  1316.  
  1317.      Page 20                                         (printed 4/30/98)
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.      XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))
  1325.  
  1326.  
  1327.  
  1328.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttHHHHiiiigggghhhhlllliiiigggghhhhtttt((((3333XXXX)))),
  1329.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttIIIInnnnsssseeeerrrrttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))),
  1330.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttMMMMaaaaxxxxLLLLeeeennnnggggtttthhhh((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXX)))),
  1331.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSttttrrrriiiinnnngggg((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSttttrrrriiiinnnnggggWWWWccccssss((((3333XXXX)))),
  1332.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSShhhhoooowwwwPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))), and XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddXXXXYYYYTTTTooooPPPPoooossss((((3333XXXX)))).
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.      Page 21                                         (printed 4/30/98)
  1384.  
  1385.  
  1386.  
  1387.